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package servers- 



import java.io.*; 
import util.*; 

// System Configuration Information, 
public class Systemlnfo 



{ 



// Boolean System Option Bitmasks. 



public final static int 
ser self -registration enabled. 

public final static int 
adge login and logout enabled. 

public final static int 
ptions. 



boSelf Register 

boLoglnAndOut 

boDefault 



si; 

iOptions; 
sAdminPassword ; 
sCompany; 

cDaysToKeepMessages ; 
iTimeToSweep ; 



public static Systemlnfo 

public int 
tions bitmask. . 

. public String 
ator password. 

public String 
company name. 

public int 
to keep messages before deleting. 

public long 
ay to sweep in millisecs since midnight. 

public Mail Info mi; 
rmation. 

public Telephonylnfo ti; 
information. 

public User Info uiDefault; 

serlnfo. 

public int i For cedOp tions; 

ons bitmask for options that are forced to system default. 

public int iDef aultPermissions; 

ns granted to each user by default. 

public int iForcedPermissions; 
issions bitmask for permissions that are forced to system default. 

public StringSet ssPersonas; 
genie personas. 

public StringSet ssRingTones; 
ring tone file names. 

p\iblic boolean bPorcedPer sona ; 

ersona selection is forced to default. 

public boolean bForcedRingTone ; 

ingtone selection is forced to default. 

// Default constructor. 

p\iblic Systemlnfo (ServerConfig sc) 

thisO; 

iOptions 
sAdminPassword 
sCompany 

CDaysToKeepMessages 
iTimeToSweep 
mi 
ti 



0x1; // True if u^ 
0x2; // True if b-» 
0x2; // Default o-» 

// System op-» 
// Administr-t 
// Customer 
// # of days- 
// Time of d-" 
// Mail info-^ 
// Telephony-i 
// Default 
// User opti"» 
// Permissio-« 
// User perm-^ 
// Available-i 
// Available-! 
// True if p-i 
// True if r-» 



sc . getSystemOpt ions ( ) ; 
sc . getAdminPassword ( ) ; 

ti n . 

sc.getDaysToKeepMessages 0 ; 
sc . getTimeToSweep ( ) ; 
new Maillnfo(sc) ; 
new Telephony Inf o (sc) ; 



File c:\bldw\server\src\ser- Systemlnfo. java 
Page 2 of 10 7-31-2002. i9:52 am 



uiDef ault 

i ForcedOp t ions 

iDe f aul t Permi s s i ons 

iPorcedPermissions 

bPorcedPersona 

bForcedRingTone 



new Userlnfo(sc) ; 

sc . get ForcedOpt ions ( ) ; 

sc.getDefaultPermissionsO ; 

sc.getForcedPermissions 0 ; 

sc. isForcedPersona ( ) ; 

sc. isForcedRingTone ( ) ; 



} 



// Copy constructor., 
public Systemlnfo (Systemlnfo 

{ 

iOptions = 

sAdmi nPa s sword = 

sCompany . = 

cDay sToKeepMe s s age s = 
iTimeToSweep 

mi . = 
ti 

uiDefault 

i ForcedOpt ions - 

iDef ault Permissions = 

iPorcedPermissions = 

ssPersonas = 

ssRingTones = 

bPorcedPersona = 

bForcedRingTone = 

} 

private Systemlnfo {) 

{ 

f indlnstalledPersonas ( ) ; 
f indlnstalledRingTones 0 ; 



si) 



si. iOptions; 

si . sAdminPas sword ; 

si. sCompany; 

si . cDaysToKeepMessages J 

si . iTimeToSweep; 

si. mi. copy 0 ; 

si. ti.copy 0 ; 

si.uiDef ault .copy () ; 

si . iPorcedOptions ; 

si . iDef aultPermissions ; 

si . iPorcedPermissions; 

si . ssPersonas . copy ( ) ; 

si . ssRingTpnes . copy ( ) ; 

si . bPorcedPersona ; 

si . bForcedRingTone ; 



} 



// Returns initial Userlnfo for creating a user, 
public Userlnfo getDefaultUserlnfoO 
return uiDefault . copy ( ) ; 

// Sets array of names of installed genie personas, vjhich are subdirectories of the 
prompts subdirectory. 

// (E.g. "Corporate", "Bombshell", "Stud", "StarFleet") 

private void f indlnstalledPersonas {) 

{ 

String [] saPersonas; 



try 
{ 



File f 
saPersonas 

} 

catch (Exception e) 

{ 

saPersonas 

} 



new File (getVoceraHome ( ) + " /data/prompts" ) ; 
f .listO; 



= null; 
Debug. assert (saPersonas != null); 
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ssPersonas = new StringSet (saPersonas) ; 

ssPersonas . ini tCap ( ) ; 
ssPersonas . remove ( "Common" ) ; 

} 

public static String getVoceraHome ( ) 

^ return ServerConf ig . getVoceraHome ( ) ; 

// Sets array of names of installed ring tones, 
private void f indlnstalledRingTones () 

String [] saRingTones = new String [0] ; 

class Filter implements FileFilter 

{ 

public boolean accept (File f) 

{ 

^ return f . getName ( ) . endsWith ( " . wav" ) ; 

try 
{ 

File f = new File (getRingTonesDir ()) ; 

saRingTones = f . list ( ) ; 

} 

catch (Exception e) 

{ 

Debug. fail (e) ; 
ssRingTones = new StringSet () ; 



} 



for (int i = 0; i < saRingTones . length; ++i) 

ssRingTones . add ( saRingTones [i] . substring (0 , saRingTones [i] . length ( ) - 4 ) ) ; 



public Systemlnfo copyO 

return new Systemlnfo (this) ; 

// Returns directory for downloads of new firmware, 
public String getDownloadDir () 

return getVoceraHome ( ) + "/data/downloads"; 

// Returns directory for voice message storage 
public String getVMessageDir () 

return getVoceraHome { ) + "/data/messages"; 

// Returns directory for user prompts, 
public String getUserDirO 
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{ 

return getVoceraHome ( ) + "/data/user"; 

} 

// Returns directory for location prompts, 
piablic String getLocationDir () 

{ 

return getVoceraHome ( ) + "/data/location"; 

} 

// Returns directory for prompts. 

public String getPromptsDir (String sSubdir) 

{ 

^ return getVoceraHome ( ) + "/data/prompts/" + sSxibdir; 

// Returns directory for common prompts, such. as beeps, 
public String getCommonPromptsDir ( ) 

{ . 

return getPromptsDir ( "common" ) ; 

} 

// Returns directory for ring tones, 
public String getRingTonesDir () 

{ 

^ return getVoceraHome () + "/data/ringtones" ; 

/* 

// Returns directory for voice enrollment files. 

public String getEnrollmentDir ( ) 
{ 

return getVoceraHome { ) + "/data/enrollment"; 

*/ 

// Returns set of supported personas. 
pxiblic StringSet getGeniePersonas () 
return ssPersonas; 

} 

// Returns default genie persona, 
ptiblic String getDef aultPersona {) 

{ 

return uiDef aul t . o . sGeniePersona ; 

} 

// Returns filename of persona introduction .wav file corresponding to persona with 
given name. 

// Path of filename is relative to /sounds/ context in web server, 
pxiblic String getPersonalntroductionFileName (String sPersona) 
^ return get Prompt FileName (sPersona, P. persona introduction) ; 
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// Returns filename of .wav file giving tonal greeting for persona with given name. 
// Path of filename is relative to /sounds/ context in web server. 

public String getGenieEarconFileName (String sPersona) 

^ return getPromptPileName (sPersona, P.genie^earcon) ; 

// Returns filename of .wav file giving spoken greeting for persona with given name. 
// Path of filename is relative to /so\mds/ context in web server. 

p\iblic String getGenieFileName (String sPersona) 

^ return getPromptPileName (sPersona, P. genie ) ; 

private" String getPromptPileName (String sPersona, int iPrompt) 
{ ' 

^ return "/prompts/" + sPersona + "/" + Prompt .get FileName (i Prompt) + ".wav"; 

// Checks that sPersona is among available personas. 

// If so, just returns it, otherwise returns default persona. 

public String checkPersona (String sPersona) 

if (bForcedPersona || ! ssPersonas. contains (sPersona) ) 
return getDefaul tPersonaO; 

else 

^ return sPersona; 

// Returns set of supported ringtones. 
// Note: Only the root name is provided. 

// Use getRingToneFilename below to get the fully-qualified file name, 
public StringSet getRingTones ( ) 
return ssRingTones; 

// Returns default ring tone, 
public String getDef aultRingTone () 
^ return uiDefault .o. sRingTone; 

// Given a ring tone name, returns the corresponding filename. 

// Path of filename is relative to /sounds/ context in web server. 

public String getRingTone FileName (String sRingTone) 

^ return "/ringtones/" + sRingTone + ".wav"; 

// Checks that sRingTone is among available ring tones. 

// If so, just returns it, otherwise returns default ring tone, 

public String checkRingTone (String sRingTone) 
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if (bForcedRingTone | | ! ssRingTones. contains (sRingTone) ) 
return getDefaultRingToneO ; 

else 

return sRingTone; 

} 

// Returns prompt path as a function of the given persona. 



public String [1 getPrompt Path (String sPersona) 

{ 

String [] sProraptPath; 



sPromptPath = new String [6] ; 

sPromptPathtO] = ge t Prompt sDir (sPersona) ; 

sPromptPath [1] = getCoiranonPromptsDir ( ) ; 

sPromptPathl2l = getUserDirO ; 

SPromptPath [3] = getVMessageDir ( ) ; 

sPromptPath [4] = getLocationDir () ; 

SPromptPath I5] = getRingXonesDir ( ) ; 

return sPromptPath; 

} 



// Returns default prompt path. 



public String [] getDef aultPromptPath () 

{ 

return ge t Prompt Path (getDef ault Persona () ) ; 



// Returns true if all boolean system-wied options defined by iMask are set. 
public boolean hasOptions (int iMask) 



return (iOptions & iMask) == iMask; 



// Sets/Resets given boolean system-wide options. 

pxiblic void setOpt ions (int iMask, boolean bSet) 
{ 

if (bSet) 

iOptions 1= iMask; 

else 

iOptions &= -iMask; 

} 



// Returns effective user options obtained by combining forced values with nominal v-^ 
alues given by iUserOptions . 



p\iblic int mergeForcedOptions(int iUserOptions) 

return (iUserOptions & - i For cedOpt ions) | (iForcedOptions & uiDefault.o. iOptions-. 

} 



// Returns true if current default permissions setting satisfies iMask. 
public boolean hasDef aultPermissions (int iMask) 



return (iDefaultPermissions & iMask) == iMask; 
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// Returns effective user options obtained by combining forced values with nominal v-. 
alues given by iUserOptions . 

public int mergeForcedPermissions (int i Permissions) 
{ 

return (iPermissions & -iForcedPermissions) | (iForcedPermissions & iDef aultPerm-i 
issions) ; 

} 

// Sets/Resets given default permissions. 

pxiblic void setDefault Permissions (int iMask, boolean bSet) 
{ 

if (bSet) 

iDef aultPermissions |= iMask; 

else 

iDef aultPermissions &= -iMask; 

} 

// Returns array of filenames for call anno\mcement prompts available to the user. 
// These are found in common proir^ts directory, nominally set to /bldw/dat a/prompt s/-i 
common . 

// For example, array may contain "/bldw/data/prompts/common/f oo. wav" . 
public String [] get Prompt Fi 1 eNames () 

return WaveReader . listNonSystem (getDownloadDir ( ) + V * ) ; 

// Writes Systemlnfo to a stream. 

public void write (DataOutputStream s) throws lOException 

. s.writeint (iOptions) ; 

s.writeUTF (sAdminPassword) ; 

s . wri teUTF ( sCompany ) ; 

s . writeint (cDaysToKeepMessages) ; 

s . wri teLong ( iTimeToSweep) ; 

mi .write (s) ; 

ti .write (s) ; 

uiDefault .write (s) ; 

s.writeint (iForcedOptions) ; 

s.writeint {iDef aultPermissions) ; 

s.writeint (iForcedPermissions) ; 

s . wri teBoolean (bForcedPersona) ; 

s.writeBoolean(bForcedRingTone) ; 

// Reads Systemlnfo from a stream. 

pxiblic static Systemlnfo read (DatalnputStream s) throws lOException 

Systemlnfo si = new Systemlnfo () ; 

si.iOptions = s.readlntO 

si . sAdminPassword = s . readUTF ( ) 

si. sCompany = s.readUTFO 

si . CDaysToKeepMessages = s . readint ( ) 

si . iTimeToSweep = s . readLong ( ) ; 

si -mi = Maillnfo.read(s) ; 

si.ti = TelephonyInfo.read{s) ; 

si. uiDefault = Userlnfo. read(s) ; 
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} 



si . iForcedOptions 
si .iDef aultPermissions 
si . ii?orcedPermissions 
si .bPorcedPersona 
si .bPorcedRingTone 

return si; 



s. readint () 
s . readint ( ) 
s. readint {) 
s - readBoolean ( ) 
s . readBoolean ( ) 



// Telephony integration. 

public static class Telephonylnfo 

{ 



public boolean 
hony enabled. 

public String 

de. 

public String 
equence for local calls. 

public String sLongDistanceAccess; 
equence for calls in which area code must be suppliled. 

public String sVoiceMail Access; 

et into voice mail. 



bEnabled; 
sAreaCode ; ' 
sLocal Access ; 



public Telephonylnfo (Server Config sc) 

{ 



} 



bEnabled 
sAreaCode 
sLocalAccess 
sLongDistanceAccess 
s Voi ceMa i 1 Ac cess 



// True if telep-» 
// Local area co-» 
// Line access s-» 
II Line access s-> 
// Sequence to g-i 



sc . isTelephonyEnabled { ) ; 

sc . getAreaCode ( ) ; 

sc . getLocalAccess ( ) ; 

sc .getLongDistanceAccess ( ) ; 

sc.getVoiceMailAccess 0 ; 



// Copy constructor. 



public Telephonylnfo (Telephonylnfo ti) 

{ 

bEnabled = ti. bEnabled; 

sAreaCode = ti . sAreaCode; 

sLocalAccess = ti . sLocalAccess ; 

SLongDistanceAccess = t i . sLongDistanceAccess ; 

sVoiceMailAccess = t i . sVoiceMailAccess ; 

} 



public Telephonylnfo ( ) 

{ 
} 

public Telephonylnfo copyO 

{ 

return new Telephonylnfo (this) ; 

} 

public static Telephonylnfo read (Data Input St ream s) throws lOException 
Telephonylnfo ti = new Telephonylnfo () ; 



ti .bEnabled 

t i . sAreaCode = 

ti . sLocalAccess = 

ti .sLongDistanceAccess = 

ti . sVoiceMailAccess = 



s . readBoolean ( ) ; 
s . readUTF ( ) 
s . readUTF ( ) 
s . readUTF ( ) 
s . readUTF ( ) 



File c:\bldw\server\src\ser. .iSystemlnfo. java 
Page 9 of 10 7-31-2002 i9:52 am 



} 



return ti; 



} 



public void write (DataOutputStream s) throws lOException 

{ 

s.writeBoolean(bEnabled) ; 
s.writeUTF(sAreaCode) ; 
s.writeUTF(sLocalAccess) ; 
s . writeUTF (sLongDistanceAccess) ; 
s.writeUTF(sVoiceMailAccess) ; 

} 



public static class Maillnfo 

{ 

// Mail server type. 



public String 



"imap" 



public String 
public String 
public String 
pxiblic String 
pxiblic int 
al in milliseconds. 

public String 
default mail recipient. 



sServerType; 

sHost ; 
sUserName ; 
sPas sword; 
sSMTPHost ; 

iCheckInt ervalMil 1 i s ; 
sDef aultRecipient ; 



// One of '^popS" or 

// Mail host. 
// Client username. 
// Client password. 
// SMTP mail host. 
// Mail check interv 

// Email address of 



// Gets default Maillnfo. 
public Maillnfo (ServerConfig sc) 

{ 



} 



sServerType 

sHost 

sUserName 

sPassword 

sSMTPHost 

iChecklntervalMillis 
sDef aultRecipient 



// Copy constructor. 



sc .getMailServerType () ; 

sc . getMai iHos t ( ) ; 

sc .getMailUserName ( ) ; 

sc. getMai 1 Password 0 ; 

sc . getMai ISMTPHost ( ) ; 

sc .getMai IChecklnterval () ; 

sc. getMailDef aultRecipient 0 ; 



public Maillnfo (Maillnfo mi) 

{ 

sServerlVP® 

sHost = 
sUserName = 
sPassword = 
sSMTPHost 

iCheckInt ervalMil 1 is = 
sDefaultRecipient - = 

) 

public Maillnfo 0 

{ 
} 

public Maillnfo copyO 

{ 

return new Maillnfo ( this ) ; 

} 



mi . sServerType ; 

mi . sHost ; 

mi . sUserName ; 

mi . sPassword; 

mi . sSMTPHost ; 

mi . iChecklntervalMillis ; 

mi . sDefaultRecipient ; 
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public static Maillnfo read(DataInputStream s) throws lOException 
{ 



Maillnfo 



mx 



} 



mi . sServerType 

mi . sHost 

mi . sUserName 

mi . sPassword 

mi . sSMTPHost 

mi . iChecklntervalMillis 

mi . sDef aultRecipient 

return mi; 



new Maillnfo (); 



-s.readXJTFO 
s . readUTF ( ) 
s . readXITF ( ) 
s . readUTF { ) 
s . readUTF ( ) 
s.readint {) 
s . readUTF ( ) 



} 



public void write (DataOutputStream s) throws lOException 

{ 

s. writ eUTF( sServerType) ; 

s. writeUTF{sHost) ; 

s . writeUTF (sUserName) ; 

s . writeUTF (sPassword) ; 

s. writeUTF (sSMTPHost) ; 

s.writeint (iChecklntervalMillis) ; 

s. writeUTF (sDef aultRecipient) ; 

} 



public void merge (Systemlnfo siOld, Systemlnfo siBase) 

{ 

(new Merger 0 ) .merge (this, siOld, siBase); 

} 

// Three-way merger. 

private static class Merger extends ThreeWayMerger 

{ 

static String sBitVectors [] = 

{ 

"iOptions"^ "iDef aultPermissions" , "iForcedPermissions" , "i Permissions" . 

}; 

piiblic Merger 0 

{ 

super (sBitVectors) ; 

} 

public boolean isAtomic (Class c) 

{ 

return super. isAtomic (c) | | c == Userlnfo. Forwardinglnfo. class || c == Buddy-i 

Set. class; 

} 

} 

} 



